Skip to content

chore: prepare SDK 3.0.0 and OTel 2.0.0 release - #1047

Merged
ParidelPooya merged 23 commits into
mainfrom
release/js-core3-otel2-20261021
Oct 26, 2026
Merged

ParidelPooya merged 23 commits into
mainfrom
release/js-core3-otel2-20261021

Conversation

@zhongkechen

@zhongkechen zhongkechen commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Issue Link, if available

Prepare the coordinated major release from merged #924.

Description

This PR prepares the release sdk-3.0.0 / otel-2.0.0 / test-1.3.2. It adds:

  • Release notes with per-package changes, each cited by merge commit. They cover main through 9de0c7f2.
  • A 2.x-to-3.0 migration guide.
  • A change summary under Unreleased in CHANGELOG.md.
  • The release decisions in RELEASING.md.
  • Version bumps for three packages that npm already has. This PR changes no runtime code and no publishing workflow.

Package versions

npm state checked on 2026-10-25 with npm view. The publisher decision comes from running decide-dist-tag.js against that state.

Package Version npm today Publisher decision
@aws/durable-execution-sdk-js 3.0.0 latest is 2.7.1 latest
@aws/durable-execution-sdk-js-otel 2.0.0 latest is 1.2.1 latest
@aws/durable-execution-sdk-js-testing 1.3.2 latest is 1.3.1 latest
@aws/durable-execution-sdk-js-eslint-plugin 1.2.0 (bumped here) latest is 1.1.1 latest
@aws/durable-execution-sdk-js-telemetry-exporter 0.1.0-alpha.1 (bumped here) latest is 0.1.0-alpha.0 beta
@aws/durable-execution-sdk-js-telemetry-mcp 0.1.0-alpha.1 (bumped here) latest is 0.1.0-alpha.0 beta

Core, OTel and Testing versions come from #924.

Why three packages are bumped

  1. The publisher skips a version that npm already has.
  2. Telemetry Exporter and MCP 0.1.0-alpha.0 were published on 2026-10-22, outside the release workflow. npm records their gitHead as 6597e075, the refactor(sdk): create one plugin instance per invocation #924 merge commit.
  3. So the 3 exporter fixes and 3 MCP fixes merged after 6597e075 need a new version. This PR uses 0.1.0-alpha.1. It does not take the 1.0.0 bump from chore(telemetry): bump exporter and MCP to 1.0.0 #1030.
  4. ESLint plugin 1.1.1 was published on 2026-08-14. The new rule from 3cbb456c and e2f013fa needs a new version. This PR uses the minor bump 1.2.0.

0.0.2 was considered for the exporter and rejected. It sorts below 0.1.0-alpha.0. So the publisher would put it on a v0 tag, and latest would keep the version without the fixes.

After publishing

The manual publication left latest on 0.1.0-alpha.0 for both Telemetry packages. The publisher puts 0.1.0-alpha.1 on beta and does not move latest. So a maintainer must run:

npm dist-tag add @aws/durable-execution-sdk-js-telemetry-exporter@0.1.0-alpha.1 latest
npm dist-tag add @aws/durable-execution-sdk-js-telemetry-mcp@0.1.0-alpha.1 latest

The published exporter 0.1.0-alpha.0 requires Core >=3.0.0 <4.0.0. npm cannot satisfy that peer until Core 3 is published.

Not published by this release

Extras and MicroVM Worker stay excluded from automatic publishing. Their changes on main are not in this release. The Telemetry CDK stack is not in the npm package. Its fixes ship from the repository.

Work not included

PR Scope State
#1014 Invocation admission, deadline and cleanup fixes Open
#1035 Wrapper getter and thenable failure containment Open. 4e4e9407 already covers a wrap hook that rejects on its own. The follow-up #1037 stays separate
#928 LMI regression harness and acceptance evidence Open. Adds tests only

If any of these merges before the release commit is selected, update the release notes. Refresh the notes against the selected release commit before publishing the GitHub Release.

Demo/Screenshots

Not applicable. The release notes and migration guide are included for review.

Checklist

  • I have filled out every section of the PR template
  • I have thoroughly tested this change

Testing

Unit Tests

  • ESLint plugin: 168 tests passed with version 1.2.0. The plugin reads meta.version from package.json.
  • Telemetry MCP: npm run build passed. dist/server.js contains 0.1.0-alpha.1.
  • package-lock.json changes only the three version fields.
  • Earlier: 102 plugin-loader and invocation-lifetime tests passed for the migration guide.

Integration Tests

The failed integration-tests (24.x) run on 5519e9f0 was parent-context-in-step (cloud). It exceeded its 5 s Jest timeout against the cloud function. That commit changed only Markdown files, and the same job passes on main. This push runs it again.

Earlier: the migration examples typechecked against built Core 3 / OTel 2 declarations, in ESM and CJS, with strict checking and skipLibCheck: false. No package publication or cloud acceptance is claimed.

Examples

  • Merged main at 9de0c7f2 without conflicts.
  • Ran decide-dist-tag.js against live npm state for 0.0.2, 0.1.0-alpha.1 and 0.1.0.
  • Checked each release-note claim against the merge commits and source. Examples: the 3 ms cooldown constant, the faas.max_memory byte conversion, and onOperationEnd running through fireAndForget.
  • Relative links resolve. git diff --check passes. No prose semicolons remain.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 21, 2026 18:37 — with GitHub Actions Inactive
@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 21, 2026 18:38 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

hln33
hln33 previously approved these changes Oct 21, 2026
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 21, 2026 19:48 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 22, 2026 17:39 — with GitHub Actions Inactive
Comment thread docs/migration-2.x-to-3.0.md Outdated
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 22, 2026 20:42 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 22, 2026 22:35 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 22, 2026 22:47 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 23, 2026 23:07 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 23, 2026 23:59 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 24, 2026 00:16 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

yaythomas
yaythomas previously approved these changes Oct 24, 2026
@zhongkechen
zhongkechen temporarily deployed to ai-pr-review-runtime October 24, 2026 01:30 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

Add the Core, OTel and Testing SDK changes merged after 85fc08d, including the operation-hook scheduling break, deserialization and cooldown behavior, invoke cause names, batch fixes and faas.max_memory units. Record that the Telemetry packages and the ESLint plugin are already on npm, so their later changes need a version bump to ship. Add a migration-guide section for behavior changes outside plugins.
Comment thread release-notes/sdk-3.0.0.md Outdated
@github-actions

This comment has been minimized.

@yaythomas yaythomas left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Five inline comments. Content of the guide checks out against main (3 ms cooldown, 500/50 ms drain bounds, faas.max_memory, cause.name); the changes are to scope and writing, not facts.

Comment thread release-notes/sdk-3.0.0.md Outdated
Comment thread CHANGELOG.md Outdated
Comment thread RELEASING.md Outdated
Comment thread docs/migration-2.x-to-3.0.md Outdated
Comment thread docs/migration-2.x-to-3.0.md
…1.2.0

npm already has Telemetry Exporter and MCP 0.1.0-alpha.0 and ESLint plugin 1.1.1. The publisher skips a published version. So the fixes merged after those versions ship only with a new version.
Reduce the release notes to per-package changes cited by merge commit. Move release preparation to the PR description. Replace the CHANGELOG preparation entry with a change summary. State the version-bump decision and the manual latest dist-tag step in RELEASING.md. Split prose semicolons into separate sentences. Remove the incorrect claim that a child context's onOperationEnd hook holds the invocation open.
@ParidelPooya
ParidelPooya temporarily deployed to ai-pr-review-runtime October 26, 2026 02:44 — with GitHub Actions Inactive
@github-actions

Copy link
Copy Markdown

Codex AI review

No actionable findings. The three prior findings are resolved; runtime code and invariant contract tests are unchanged. Review was static: tests, package installation, and publication were not run.

Reviewed commit d3b2b4385968b86053f156f212bcf1f5782cc237. Workflow run

@ParidelPooya
ParidelPooya merged commit 13b8ae5 into main Oct 26, 2026
105 of 111 checks passed
@ParidelPooya
ParidelPooya deleted the release/js-core3-otel2-20261021 branch October 26, 2026 03:10

This branch was previously deployed

1 inactive deployment
ai-pr-review-runtime — d3b2b438 Deployed Oct 26, 2026 by ParidelPooya via ai-pr-review / Codex review / Generate Codex review #2096
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants